ComponentOne Bitmap for WinForms
C1.Win.C1DX.4.8 Assembly / C1.Util.DX.DirectWrite Namespace / TextLayout Class / Create Method / Create(Factory,String,TextFormat,Single,Single,Single,Nullable<Matrix3x2>,Boolean) Method
an instance of Factory
An array of characters that contains the string to create a new C1.Win.DX.DirectWrite.TextLayout object from. This array must be of length stringLength and can contain embedded NULL characters.
The text formatting object to apply to the string.
The width of the layout box.
The height of the layout box.
The number of physical pixels per DIP (device independent pixel). For example, if rendering onto a 96 DPI device pixelsPerDip is 1. If rendering onto a 120 DPI device pixelsPerDip is 1.25 (120/96).
An optional transform applied to the glyphs and their positions. This transform is applied after the scaling specifies the font size and pixels per DIP.
Instructs the text layout to use the same metrics as GDI bi-level text when set to FALSE. When set to TRUE, instructs the text layout to use the same metrics as text measured by GDI using a font created with CLEARTYPE_NATURAL_QUALITY.

In This Topic
    Create(Factory,String,TextFormat,Single,Single,Single,Nullable<Matrix3x2>,Boolean) Method
    In This Topic
    Create a Gdi Compatible TextLayout. Takes a string, format, and associated constraints, and produces an object representing the result, formatted for a particular display resolution and measuring mode.
    Syntax
    'Declaration
     
    Public Overloads Shared Function Create( _
       ByVal factory As Factory, _
       ByVal text As System.String, _
       ByVal textFormat As TextFormat, _
       ByVal layoutWidth As System.Single, _
       ByVal layoutHeight As System.Single, _
       ByVal pixelsPerDip As System.Single, _
       ByVal transform As System.Nullable(Of Matrix3x2), _
       ByVal useGdiNatural As System.Boolean _
    ) As TextLayout
    public static TextLayout Create( 
       Factory factory,
       System.string text,
       TextFormat textFormat,
       System.float layoutWidth,
       System.float layoutHeight,
       System.float pixelsPerDip,
       System.Nullable<Matrix3x2> transform,
       System.bool useGdiNatural
    )

    Parameters

    factory
    an instance of Factory
    text
    An array of characters that contains the string to create a new C1.Win.DX.DirectWrite.TextLayout object from. This array must be of length stringLength and can contain embedded NULL characters.
    textFormat
    The text formatting object to apply to the string.
    layoutWidth
    The width of the layout box.
    layoutHeight
    The height of the layout box.
    pixelsPerDip
    The number of physical pixels per DIP (device independent pixel). For example, if rendering onto a 96 DPI device pixelsPerDip is 1. If rendering onto a 120 DPI device pixelsPerDip is 1.25 (120/96).
    transform
    An optional transform applied to the glyphs and their positions. This transform is applied after the scaling specifies the font size and pixels per DIP.
    useGdiNatural
    Instructs the text layout to use the same metrics as GDI bi-level text when set to FALSE. When set to TRUE, instructs the text layout to use the same metrics as text measured by GDI using a font created with CLEARTYPE_NATURAL_QUALITY.
    Remarks
    The resulting text layout should only be used for the intended resolution, and for cases where text scalability is desired {{CreateTextLayout}} should be used instead.
    See Also